APPENDIX 1 


LAPI_Nopoll_wait Subroutine 
Purpose 

LAPI_Nopoll_wait- Provides a counter value and a state vector corresponding to a 
list of destinations from which a response is expected to be updated once all the 
messages being waited for that will arrive have arrived. 

Library 

Availability Library (liblapi_r.a) 

C Syntax 

# include <lapi.h> 

void LAPI_NopoII_wait (hndl, cntr _ptr, val, cur _cntr jyal) 
lapi_handle_f hndl; 
lapi_cntr_t *cntr _ptr; 
int val; 

int *cur_cntr_val; 

FORTRAN Syntax 

include 'lapith' 

int LAPI_NOPOLL_WAIT (HNDL, CNTR_PTR, VAL, CUR_CNTR_VAL, IERROR) 

INTEGER hndl; 

INTEGER cntr _ptr; 

INTEGER val; 

INTEGER cur_cntr_val; 

INTEGER terror; 

Parameters 

hndl IN Handle to the LAPI instance 

*cntr_ptr IN/OUT Pointer to the lapi_cntr_t structure 

val IN The relative counter value starting from 1 to be reached before 

returning. 

*cur__cntr_val IN Returns the current integer value of counter if not NULL. 

ierror OUT Specifies a FORTRAN return code. It is always the last 

argument 

Description 

This function first checks if the state of counter is WAIT. It returns immediately with 
a return error of LAPLERR_MULTIPLE_WAITERS if it is already in a WAIT state. 
Then it checks if the counter values for val and *cntr_ptrare the same and returns 
immediately if the value has been reached. Otherwise, it records in the lapi_cntr__t 
(*cntr_ptr) structure the value to be reached. There are two fields associated with 
the counter; *dest_list and *dest_status array of size val or NULL. *dest_list and 
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*dest_status arrays record task IDs from which the calling thread is waiting for a 
response. These fields should only be set using LAPI_Setcntr_wstatus. This 
function will immediately return with a return value of LAPI_ERR_PURGED_TASK 
if the destinations are purged. If *dest_list is NULL then the behavior of 
LAPI_Purge_totask is to wake up all the threads that were sleeping in the 
LAPIJMopoll_wait. 


Note: To use this function you must have the lib_vers field of lapi_info_t in 
LAPIJnit set to L2JJB or later. 

Return Values 

LAPI_SUCCESS Indicates the state was successfully reset. 

LAPLERR_PURGED_TASK 

Returned early due to LAPI_Purge_totask being called. 

LAPI_ERR_MULTIPLE_WAITERS 

More than one thread is waiting for the counter 

LAPI_ERR_BAD„PARAWIETER 

A parameter passed in was not valid. 


Location 


/usr/lib/liblapi_r.a 


Related Information 

Subroutines: LAPI_Purge_totask, LAPI_Resume_totask, 
LAPI Setcntr wstatus 
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LAPISetcntrwstatus Subroutine 
Purpose 

LAPI_Setcntr_wstatus - Sets a counter to a specified value and sets the 
associate destination list array and destination status array to the counter. 

Library 

Availability Library (liblapi_r.a) 

C Syntax 

^include <Iapi.h> 

int LAPISetcntrwstatus (hndl, cntr, val, destjist, dest_status) 
iapihandlet hndl; 
lapi_cntr_t*c«/r; 
int val; 

uint * destjist; 
int *dest_status; 

FORTRAN Syntax 

include 'lapif.h' 

LAPl_SETCmH_WSTATUS (hndl, cntr, val, destjist, dest_status, 
terror) 

INTEGER hndl; 
INTEGER cntr; 
INTEGER val; 
INTEGER destjist; 
INTEGER dest_status; 
INTEGER terror; 

Parameters 

hndl IN The handle that specifies the LAPI context 

cntr IN/OUT Specifies the address of the counter to be set. This parameter 
cannot be NULL. 

val IN Specifies the value the counter needs to be set to. 

*destjist IN Specifies an array of destinations waiting for this counter update or 
NULL 

*dest_status 

IN/OUT Specifies an array of status (or NULL) corresponding to 
destjist 

ierror OUT Specifies a FORTRAN return code. It is always the last argument. 

Description 

This function sets the cntr to the appropriate value. It returns with 
LAPI_ERRJ3AD_PARAMETER if destjist \$ not NULL and *dest_status is. 
destjist and *dest_status record the status of a task from where the thread calling 
LAPI_Nopoll_wait() is waiting for a response. Status has the following format: 

LAPI_MSG_AWAIT_RESP 
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Not received or purged. 

LAPI_MSG_RECVD 

Received. 

LAPI_MSG_PURGED 

Purged and not received. 

LAPI_MSG_PURGED_RCVD 

Purged and received. 

LAPI_MSG_INVALID 

Not valid; the task is already purged. 

Note: This function should not be used when the parallel application is running under 
the POE/LL environment. 

Return Values 

LAPI_SUCCESS Indicates sucessful completion. 

LAPI_ERR_BAD_PARAMETER 

Indicates that a parameter was passed in that was not valid. 

Location 

/usr/lib/liblapi_r.a 

Related Information 

Subroutines: LAPI_Getcntr, LAPI_Nopoll_wait, LAPI_Purge_totask, 
LAPI Setcntr 
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